🎖️GitЯра🎖️ - /page/blob.mu

T8b949e/*

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.service

Tff7b72import T7ee787android.content.pm.ServiceInfo

Tff7b72import T7ee787org.junit.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertFalse

Tff7b72import T7ee787kotlin.test.assertTrue

T8b949e/**

* Rules for [ForegroundStartPolicy].

*

* These cases encode the two platform gates that produced the 2.8.0 foreground-service failures: the Android 12+

* background-start restriction, and the Android 14+ while-in-use restriction on the `location` service type.

*/

Tff7b72class T56d364ForegroundStartPolicyTest Tb4b4b4{

Tff7b72private Tff7b72companion Tff7b72object Tb4b4b4{

Tff7b72const Tff7b72val Te6edf3ANDROID_10 Tff7b72= T79c0ff2T79c0ff9

Tff7b72const Tff7b72val Te6edf3ANDROID_11 Tff7b72= T79c0ff3T79c0ff0

Tff7b72const Tff7b72val Te6edf3ANDROID_12 Tff7b72= T79c0ff3T79c0ff1

Tff7b72const Tff7b72val Te6edf3ANDROID_13 Tff7b72= T79c0ff3T79c0ff3

Tff7b72const Tff7b72val Te6edf3ANDROID_14 Tff7b72= T79c0ff3T79c0ff4

Tff7b72const Tff7b72val Te6edf3ANDROID_17 Tff7b72= T79c0ff3T79c0ff7

Tff7b72const Tff7b72val Te6edf3CONNECTED_DEVICE Tff7b72= Te6edf3ServiceInfoTb4b4b4.Te6edf3FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE

Tff7b72const Tff7b72val Te6edf3LOCATION Tff7b72= Te6edf3ServiceInfoTb4b4b4.Te6edf3FOREGROUND_SERVICE_TYPE_LOCATION

T8b949e/** Platform levels that enforce the background foreground-service-start restriction. */

Tff7b72val Te6edf3RESTRICTED_LEVELS Tff7b72= Te6edf3listOfTb4b4b4(Te6edf3ANDROID_12Tb4b4b4, Te6edf3ANDROID_13Tb4b4b4, Te6edf3ANDROID_14Tb4b4b4, Te6edf3ANDROID_17Tb4b4b4)

Tb4b4b4}

T8b949e// region background-start restriction

Tf0883e@Test

Tff7b72fun Td2a8ff`before Android 12 every trigger may start in the background`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3ServiceStartTriggerTb4b4b4.Te6edf3entriesTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3trigger Tff7b72-Tff7b72>

Te6edf3assertTrueTb4b4b4(

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3isForegroundStartAllowedTb4b4b4(Te6edf3triggerTb4b4b4, Te6edf3appInForeground Tff7b72= Tff7b72falseTb4b4b4, Te6edf3sdkInt Tff7b72= Te6edf3ANDROID_11Tb4b4b4)Tb4b4b4,

Ta5d6ff"Tffd700$Te6edf3triggerTa5d6ff should be allowed pre-Android-12Ta5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`a user-visible start is allowed on every platform`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3RESTRICTED_LEVELSTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3sdk Tff7b72-Tff7b72>

Te6edf3assertTrueTb4b4b4(

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3isForegroundStartAllowedTb4b4b4(

Te6edf3ServiceStartTriggerTb4b4b4.Te6edf3UserInterfaceTb4b4b4,

Te6edf3appInForeground Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4,

Tb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6ffUserInterface should be allowed on API Tffd700$Te6edf3sdkTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`boot completed keeps its exemption even though the process is not yet visible`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3RESTRICTED_LEVELSTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3sdk Tff7b72-Tff7b72>

Te6edf3assertTrueTb4b4b4(

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3isForegroundStartAllowedTb4b4b4(

Te6edf3ServiceStartTriggerTb4b4b4.Te6edf3BootCompletedTb4b4b4,

Te6edf3appInForeground Tff7b72= Tff7b72falseTb4b4b4,

Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4,

Tb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6ffBootCompleted should be allowed on API Tffd700$Te6edf3sdkTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`a backgrounded device-address change is refused`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3RESTRICTED_LEVELSTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3sdk Tff7b72-Tff7b72>

Te6edf3assertFalseTb4b4b4(

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3isForegroundStartAllowedTb4b4b4(

Te6edf3ServiceStartTriggerTb4b4b4.Te6edf3DeviceAddressChangedTb4b4b4,

Te6edf3appInForeground Tff7b72= Tff7b72falseTb4b4b4,

Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4,

Tb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6ffDeviceAddressChanged should be refused while backgrounded on API Tffd700$Te6edf3sdkTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`a device-address change while the app is visible is allowed`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3RESTRICTED_LEVELSTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3sdk Tff7b72-Tff7b72>

Te6edf3assertTrueTb4b4b4(

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3isForegroundStartAllowedTb4b4b4(

Te6edf3ServiceStartTriggerTb4b4b4.Te6edf3DeviceAddressChangedTb4b4b4,

Te6edf3appInForeground Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4,

Tb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6ffDeviceAddressChanged should be allowed while visible on API Tffd700$Te6edf3sdkTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

T8b949e// endregion

T8b949e// region service type selection

Tf0883e@Test

Tff7b72fun Td2a8ff`no service type is claimed before Android 10`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertEqualsTb4b4b4(

T79c0ff0Tb4b4b4,

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3foregroundServiceTypeTb4b4b4(

Te6edf3hasLocationPermission Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3appInForeground Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3sdkInt Tff7b72= T79c0ff2T79c0ff8Tb4b4b4,

Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`connectedDevice alone is claimed without location permission`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertEqualsTb4b4b4(

Te6edf3CONNECTED_DEVICETb4b4b4,

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3foregroundServiceTypeTb4b4b4(

Te6edf3hasLocationPermission Tff7b72= Tff7b72falseTb4b4b4,

Te6edf3appInForeground Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3sdkInt Tff7b72= Te6edf3ANDROID_17Tb4b4b4,

Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`location is claimed in the background before Android 14`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3listOfTb4b4b4(Te6edf3ANDROID_10Tb4b4b4, Te6edf3ANDROID_12Tb4b4b4, Te6edf3ANDROID_13Tb4b4b4)Tb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3sdk Tff7b72-Tff7b72>

Te6edf3assertEqualsTb4b4b4(

Te6edf3CONNECTED_DEVICE Te6edf3or Te6edf3LOCATIONTb4b4b4,

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3foregroundServiceTypeTb4b4b4(

Te6edf3hasLocationPermission Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3appInForeground Tff7b72= Tff7b72falseTb4b4b4,

Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4,

Tb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6fflocation should still be claimable in the background on API Tffd700$Te6edf3sdkTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`location is dropped for a background start from Android 14`Tb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// The app does not declare ACCESS_BACKGROUND_LOCATION, so claiming the location type here would throw

T8b949e// SecurityException and take the whole foreground start with it.

Te6edf3listOfTb4b4b4(Te6edf3ANDROID_14Tb4b4b4, Te6edf3ANDROID_17Tb4b4b4)Tb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3sdk Tff7b72-Tff7b72>

Te6edf3assertEqualsTb4b4b4(

Te6edf3CONNECTED_DEVICETb4b4b4,

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3foregroundServiceTypeTb4b4b4(

Te6edf3hasLocationPermission Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3appInForeground Tff7b72= Tff7b72falseTb4b4b4,

Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4,

Tb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6fflocation must be dropped for a background start on API Tffd700$Te6edf3sdkTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`location is claimed for a foreground start on Android 14 and later`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3listOfTb4b4b4(Te6edf3ANDROID_14Tb4b4b4, Te6edf3ANDROID_17Tb4b4b4)Tb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3sdk Tff7b72-Tff7b72>

Te6edf3assertEqualsTb4b4b4(

Te6edf3CONNECTED_DEVICE Te6edf3or Te6edf3LOCATIONTb4b4b4,

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3foregroundServiceTypeTb4b4b4(

Te6edf3hasLocationPermission Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3appInForeground Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4,

Tb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6fflocation should be claimable while visible on API Tffd700$Te6edf3sdkTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`connectedDevice is always claimed when types are supported`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3listOfTb4b4b4(Te6edf3ANDROID_10Tb4b4b4, Te6edf3ANDROID_12Tb4b4b4, Te6edf3ANDROID_13Tb4b4b4, Te6edf3ANDROID_14Tb4b4b4, Te6edf3ANDROID_17Tb4b4b4)Tb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3sdk Tff7b72-Tff7b72>

Te6edf3listOfTb4b4b4(Tff7b72trueTb4b4b4, Tff7b72falseTb4b4b4)Tb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3hasLocation Tff7b72-Tff7b72>

Te6edf3listOfTb4b4b4(Tff7b72trueTb4b4b4, Tff7b72falseTb4b4b4)Tb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3visible Tff7b72-Tff7b72>

Tff7b72val Te6edf3types Tff7b72=

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3foregroundServiceTypeTb4b4b4(

Te6edf3hasLocationPermission Tff7b72= Te6edf3hasLocationTb4b4b4,

Te6edf3appInForeground Tff7b72= Te6edf3visibleTb4b4b4,

Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4,

Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(

Te6edf3CONNECTED_DEVICETb4b4b4,

Te6edf3types Te6edf3and Te6edf3CONNECTED_DEVICETb4b4b4,

Ta5d6ff"Ta5d6ffconnectedDevice missing on API Tffd700$Te6edf3sdkTa5d6ff (location=Tffd700$Te6edf3hasLocationTa5d6ff, visible=Tffd700$Te6edf3visibleTa5d6ff)Ta5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

T8b949e// endregion

T8b949e// region fallback type

Tf0883e@Test

Tff7b72fun Td2a8ff`the fallback type is connectedDevice only`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertEqualsTb4b4b4(Te6edf3CONNECTED_DEVICETb4b4b4, Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3fallbackForegroundServiceTypeTb4b4b4(Te6edf3sdkInt Tff7b72= Te6edf3ANDROID_17Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff0Tb4b4b4, Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3fallbackForegroundServiceTypeTb4b4b4(Te6edf3sdkInt Tff7b72= T79c0ff2T79c0ff8Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`the fallback never claims a while-in-use restricted type`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3listOfTb4b4b4(Te6edf3ANDROID_10Tb4b4b4, Te6edf3ANDROID_12Tb4b4b4, Te6edf3ANDROID_14Tb4b4b4, Te6edf3ANDROID_17Tb4b4b4)Tb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3sdk Tff7b72-Tff7b72>

Tff7b72val Te6edf3fallback Tff7b72= Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3fallbackForegroundServiceTypeTb4b4b4(Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff0Tb4b4b4, Te6edf3fallback Te6edf3and Te6edf3LOCATIONTb4b4b4, Ta5d6ff"Ta5d6fffallback must not include location on API Tffd700$Te6edf3sdkTa5d6ff"Tb4b4b4)

Tb4b4b4}

T8b949e// endregion

T8b949e/**

* The invariant behind the crash: any start the policy permits must also be startable with the types the policy

* hands out. A permitted background start that still asks for `location` on Android 14+ would throw

* `SecurityException` inside the service, which is exactly the failure this policy exists to prevent.

*/

Tf0883e@Test

Tff7b72fun Td2a8ff`a permitted background start never asks for a while-in-use restricted type`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3RESTRICTED_LEVELSTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3sdk Tff7b72-Tff7b72>

Te6edf3ServiceStartTriggerTb4b4b4.Te6edf3entries

Tb4b4b4.Te6edf3filter Tb4b4b4{ Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3isForegroundStartAllowedTb4b4b4(Tffa657itTb4b4b4, Te6edf3appInForeground Tff7b72= Tff7b72falseTb4b4b4, Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4) Tb4b4b4}

Tb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3trigger Tff7b72-Tff7b72>

Tff7b72val Te6edf3types Tff7b72=

Te6edf3ForegroundStartPolicyTb4b4b4.Te6edf3foregroundServiceTypeTb4b4b4(

Te6edf3hasLocationPermission Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3appInForeground Tff7b72= Tff7b72falseTb4b4b4,

Te6edf3sdkInt Tff7b72= Te6edf3sdkTb4b4b4,

Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3sdk Tff7b72>Tff7b72= Te6edf3ANDROID_14Tb4b4b4) Tb4b4b4{

Te6edf3assertEqualsTb4b4b4(

T79c0ff0Tb4b4b4,

Te6edf3types Te6edf3and Te6edf3LOCATIONTb4b4b4,

Ta5d6ff"Tffd700$Te6edf3triggerTa5d6ff on API Tffd700$Te6edf3sdkTa5d6ff is permitted in the background but claims locationTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}